home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 451-475 / disk_474 / aequipot / aequipot.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  153 lines
  1. --------------------------- Aequipot V1.06 --------------------------------
  2.  
  3. Aequipot is Copyright 1990, 1991 by Juergen Matern.
  4. This is a program that draws multicolor images with a certain
  5. algorithm.
  6.  
  7. ---------------------------- BACKGROUND -----------------------------------
  8.  
  9. The algorithm discribes a problem, in the Electrostatic. Sorry, but at the
  10. moment my english is too bad to describe this algorithm in english. So look
  11. at the german doc file (Aequipot.anl), may be it can help you.
  12.  
  13. ----------------------------- FEATURES ------------------------------------
  14.  
  15. * up to twenty power-sources
  16. * LoRes- and HiRes-resolution possible
  17. * optimized algorithm to solve time
  18. * fast-function to get an idea of how the final graphic looks like
  19. * works with 32, or 16 colors, depending on the modus
  20. * parameters from CLI
  21. * if started from Workbench the program asks for the parameters
  22. * repair-function, when the algorithm is making errors
  23.  
  24. ------------------------------ USAGE --------------------------------------
  25.  
  26. There are two different versions, the PAL and the NTSC version. They have
  27. different names (AequipotP and AequipotN). The program can be started from
  28. Workbench or from CLI.
  29. When the program is started from Workbench, the program asks for the two
  30. parameters it needs to work correctly.
  31. When the program is started from CLI you have to give two parameters to the
  32. program. The first is to choose the screenmode the second is to choose the
  33. renderingmode. If there is no parameter or there are wrong parameters, the
  34. following message is printed.
  35.  
  36.      Usage: AEQUIPOT ScreenMode RenderingMode
  37.             Where ScreenMode is h(igh) or l(ow)
  38.             and RenderingMode is s(low) or f(ast).
  39.  
  40. Now the required screen is opened. The places of the powersources can now
  41. be set by mouseclicking. If you won't any more sources then click right
  42. mousebutton. The maximum number of sources is 20. When you reach #20 the
  43. program leaves this mode. Now you can enter the power of each source. The
  44. best range is between -15 and 15. When you enter a positive number you
  45. mustn't enter the <+> because the program will stop then (it's a problem of
  46. PCQ and I can do nothin' about it, when this happens to you there is an
  47. opened screen in the background which can be removed with ARTM). When you
  48. finished the input, rendering is started. The rendering can be stopped by
  49. pressing right mousebutton. With left mousebutton you toggle the title.
  50.  
  51. When the renderingmode f(ast) was selected at the end of rendering is asked
  52. if you want the same graphic to be rendered in the s(low) mode. Choose <OK>
  53. or <Cancel> to say the program what you want.
  54. When the program rendered a graphic in mode s you're asked if any repairs
  55. should be done. Try the following and you now what I mean: coordinates
  56. (73/120) and power 1 with renderingmode s(low) and screenmode l(ow).
  57. When you choose <OK> you can select the area to be re-rendered with your
  58. mouse. Press left mousebutton at the upper left corner and release button.
  59. Move mouse to lower right corner and press again left button. Now you can
  60. see the selected area to be re-rendered. If you want the program to
  61. re-render this area then press right button. If you want another area to be
  62. re-rendered then press again left button and so on. When you choose
  63. <Cancel> the requester disappears.
  64. Now the program waits for a right button. With left one you can toggle the
  65. title (e.g. for saving the picture). When the right button was pressed the
  66. screen is closed and the graphic is lost. To save pictures you have to use 
  67. a program like Pixmate, because there is no saving function yet.
  68.  
  69. --------------------------- KNOWN BUGS ------------------------------------
  70.  
  71. * The NTSC version of the program renders in the 'slow' mode a full PAL
  72.   screen (but I don't know how to change this). The result is o.k. but the
  73.   rendering time gets longer than necessarry.
  74. * The program doesn't work with MEMGUARD III.a!
  75.   The problem occures since I use the function IntToStr().
  76.  
  77. --------------------- TO BE DONE (I hope it's done) -----------------------
  78.  
  79. * implementation of menus
  80. * function for saving the graphic
  81. * killing of the bugs
  82.  
  83. ------------------------ AUTHOR AND COPYRIGHT -----------------------------
  84.  
  85. Aequipot was written by Juergen Matern using the PD-Pascal-Compiler PCQ
  86. V1.1c. (Thanks to Patrick Quaid for writing this Compiler). The
  87. executables, the sourcecodes, the icons and the documentation files
  88. are all:
  89.  
  90.    Copyright © 1990, 1991 by Juergen Matern.
  91.  
  92. I will allow the package to be freely distributed, as long as all the files
  93. in the archive are included and unchanged.
  94.  
  95. These files are:
  96. - AequipotP      (executable/PAL version)
  97. - AequipotP.p    (sourcecode/PAL version)
  98. - AequipotP.info (the icon of AequipotP)
  99. - AequipotN      (executable/NTSC version)
  100. - AequipotN.p    (sourcecode/NTSC version)
  101. - AequipotN.info (the icon of AequipotN)
  102. - Aequipot.anl   (the german documentation)
  103. - Aequipot.doc   (this file)
  104.  
  105. Send comments, bugs, MONEY (if you want), a document in better english, 
  106. postcards, or anything else to the following address:
  107.  
  108.       Juergen Matern              
  109.       Max-Wieland-Strasse 13      
  110.       Herrlingen                  
  111.       W-7906 Blaustein            
  112.       Federal Republic of Germany 
  113.  
  114.       Phone: 07304-3745           
  115.  
  116. Have fun 8-)
  117.  
  118. --------------------------- REVISION HISTORY ------------------------------
  119.  
  120. V0.?? - December 23, 1990 to January 01, 1991:
  121.       - main programing was done.
  122.  
  123. V1.0  - January 02, 1991:
  124.       - First public release.
  125.  
  126. V1.01 - January 16, 1991:
  127.       - minor changes.
  128.       - parameters from CLI are handled.
  129.       - but no WorkBench-start any more.
  130.  
  131. V1.02 - January 21, 1991:
  132.       - minor changes.
  133.       - sqrt replaced by SPSqrt; great speed increase.
  134.  
  135. V1.03 - February 26, 1991:
  136.       - minor changes.
  137.       - sourcecode cleaned up.
  138.       - 20 powersources are handled.
  139.  
  140. V1.04 - February 27, 1991:
  141.       - the repair function was included.
  142.       - the slow-rendering after fast-rendering with same coordinates was
  143.         included.
  144.  
  145. V1.05 - March 01, 1991:
  146.       - again program can be started from WorkBench.
  147.  
  148. V1.06 - March 06, 1991:
  149.       - inclusion of two requesters (repair, re-render).
  150.       - repair and fastdrawing are put together in one procedure
  151.         (executable 700 Bytes / sourcecode 1.3 K shorter).
  152.  
  153.